Abi weekly summary reports page #1062

Abi-Liu · 2024-08-12T23:55:58Z

Description

This PR implements a new aggregation pipeline for volunteer trends data as well as fixes previous queries for the volunteer hours stats and work distribution stats

New URL format: api/reports/volunteerstats?startDate=2024-05-26&endDate=2024-06-02&comparisonStartDate=2024-05-18&comparisonEndDate=2024-05-25

Changes 9/13

Updated API to retrieve comparison data for the following queries:
- totalActiveTeams
- totalBadgesAwarded
- totalHoursWorked

   "totalBadgesAwarded": {
        "current": 40,
        "comparison": 40,
        "percentage": 0
    },
    "totalActiveTeams": {
        "current": 339,
        "comparison": 330,
        "percentage": 0.03
    },
   "totalHoursWorked": {
        "current": 161.93333333333334,
        "comparison": 342.56666666666666,
        "percentage": -0.53
    },

Changes 8/23

Updated the api to require a comparisonStartDate and comparisonEndDate
- This comparison time range is the period in time that will be compared to the current week
Created the comparison data for the Volunteer Numbers Stats
- The new data will be formatted like so:

"volunteerNumberStats": {
        "activeVolunteers": {
            "count": 1373,
            "comparisonPercentage": 0.01
        },
        "newVolunteers": {
            "count": 13,
            "comparisonPercentage": -0.32
        },
        "deactivatedVolunteers": {
            "count": 2,
            "comparisonPercentage": 1
        }
    },

NOTE the for the comparisonPercentage number. -0.32 means a decrese of 32% from the comparison week. 1 is a 100% increase

Related PRS (if any):

This PR is built off of #994

Main changes explained:

Created a new query to aggregate the monthly volunteer trends data for the past year.
Fixed bugs for the volunteer hours stats and work distribution stats to now return correct data
…

How to test:

check into current branch
do npm install and npm run dev
Log in with an owner credential to Postman via the endpoint POST http://localhost:4500/api/login and paste the JWT token into the headers tab as shown below
Query the endpoint with Postman: api/reports/volunteerstats?startDate=2024-05-26&endDate=2024-06-02&comparisonStartDate=2024-05-18&comparisonEndDate=2024-05-25
verify the data is correct

Screenshots or videos of changes:

SMitta11

I tested as per given instructions, initially sent a POST request to get a token and then GET request to get this data of volunteer stats for given start and end date and data matches exactly as given here.
Below screenshots:

AJAYINAVOLU

Changes are working as expected.

Thank You.

nikhilpittala16

I have tested the PR and everything works as expected.

…t week for volunteer numbers stats

oliviahyw

I have tested this PR and it's working as expected.

Parth-tech

Hi Abi,
The the response matches with the provided reference. The API endpoint is working well.

Reference Images:

…json structure to match frontend team

yashwanth170

I have tested this PR and it's working as expected.

vedantg24

Tested the PR as per the instructions. Changes working as expected.

vishnupriyaatheti

@Abi-Liu I have reviewed your changes. As per dates given in the description the PR is working as expected. But when I change the dates I am the below error. Can you please check and reply

I am passing below dates:
http://localhost:4500/api/reports/volunteerstats?startDate=2024-09-01&endDate=2024-09-07&comparisonStartDate=2024-09-25&comparisonEndDate=2024-09-31

Shreyav2000

Tested the PR by sending the necessary GET request and verifying the returned data. The volunteer stats, trends, and comparison percentages are working as expected. The aggregation and calculation logic for the volunteerNumberStats and volunteerTrends looks accurate. Everything is functioning as intended. Ready for approval! Nice work! I have attached the screenshots below:

sri0606

Hello @Abi-Liu , I have tested the PR as mentioned, and it worked as expected.

chu-ziyu

Hi Abi,
I have tested this PR and everything worked as expected!

…eer-status-pie-chart Strallia/Faye: Data for Volunteer Status Pie Chart on Total Org Summary Page

…omparision Nishita_team_stats_comparision_for_total_org_summary_page

…mum number of active members

…nteerStatsData

…nt date field and format response

…rAssignedTime Denish - get volunteers over assigned time

…eportsController

…nsistent date field and format response

…ted-hours Denish - volunteer completed assigned hours

…ies and comparison percentages

…teer-trends

…include comparisonPercentage

…ComparisonData Denish - Add comparison percentages to getVolunteerNumberStats

Abi-Liu added 4 commits August 9, 2024 18:35

feat: volunteer trends query

67847ce

feat: sorted query to make it more easy to work with

120db4f

feat: fixed work distribution stats query

2bcfa4f

feat: fixed query for volunteer number stats

7e5e21e

Abi-Liu added the High Priority - Please Review First This is an important PR we'd like to get merged as soon as possible label Aug 13, 2024

feat: fix query for total number of hours worked

1d79b47

SMitta11 approved these changes Aug 16, 2024

View reviewed changes

metaphor987 mentioned this pull request Aug 17, 2024

huijie role distribution pie chart for TotalOrgSummary OneCommunityGlobal/HighestGoodNetworkApp#2584

Merged

AJAYINAVOLU approved these changes Aug 21, 2024

View reviewed changes

nikhilpittala16 approved these changes Aug 21, 2024

View reviewed changes

Abi-Liu added 2 commits August 23, 2024 16:20

feat: added comparison data for volunteer number stats

cb4e288

feat: calculated growth percentage between comparison week and curren…

f494165

…t week for volunteer numbers stats

oliviahyw approved these changes Aug 25, 2024

View reviewed changes

Parth-tech approved these changes Aug 30, 2024

View reviewed changes

feat: implemented optional comparison time period and updated return …

6d6a93d

…json structure to match frontend team

yashwanth170 approved these changes Aug 31, 2024

View reviewed changes

vedantg24 approved these changes Sep 4, 2024

View reviewed changes

vishnupriyaatheti suggested changes Sep 5, 2024

View reviewed changes

Shreyav2000 self-requested a review September 6, 2024 06:49

Shreyav2000 approved these changes Sep 6, 2024

View reviewed changes

feat: added comparison logic for the get hours stats data

823dc3a

sri0606 approved these changes Sep 7, 2024

View reviewed changes

Abi-Liu added 5 commits September 7, 2024 12:58

feat: added comparison data for total hours worked

a428e77

feat: refactored get volunteer hours stats

0c479b4

feat: comparison data for total active teams

1ea32f6

feat: comparison data for badges awarded

0c6a074

feat: comparison data for tasks stats

ad8bb4d

chu-ziyu self-requested a review September 20, 2024 00:45

chu-ziyu approved these changes Sep 20, 2024

View reviewed changes

Lexie5212 self-requested a review September 20, 2024 00:54

chore: merge strallias pr to fix task stats query

9e68957

strallia mentioned this pull request Dec 2, 2024

Strallia/Faye: Data for Volunteer Status Pie Chart on Total Org Summary Page #1161

Merged

strallia and others added 4 commits December 3, 2024 19:08

Merge pull request #1161 from OneCommunityGlobal/strallia-faye-volunt…

2aaf4b1

…eer-status-pie-chart Strallia/Faye: Data for Volunteer Status Pie Chart on Total Org Summary Page

Merge pull request #1158 from OneCommunityGlobal/Nishita_team_stats_c…

fd4e810

…omparision Nishita_team_stats_comparision_for_total_org_summary_page

feat: add route /reports/teams to get the number of teams with a mini…

9ee1dbc

…mum number of active members

Add getVolunteersOverAssignedTime function and integrate into getVolu…

d34c902

…nteerStatsData

This was referenced Dec 12, 2024

Denish - get volunteers over assigned time #1176

Merged

Denish - volunteer completed hours #1177

Merged

strallia and others added 11 commits December 16, 2024 11:30

refactor: update getVolunteersOverAssignedTime to use a more consiste…

d6bee31

…nt date field and format response

Merge pull request #1176 from OneCommunityGlobal/add-getVolunteersOve…

1de6562

…rAssignedTime Denish - get volunteers over assigned time

Add getVolunteersCompletedAssignedHours function and integrate into r…

f4dde10

…eportsController

refactor: update getVolunteersCompletedAssignedHours to use a more co…

c75f5b4

…nsistent date field and format response

Merge pull request #1177 from OneCommunityGlobal/new-volunteer-comple…

e0cce97

…ted-hours Denish - volunteer completed assigned hours

feat: update getAnniversaries to return 6 month and 1 year anniversar…

dc5d9db

…ies and comparison percentages

Add comparison percentage logic to volunteer stats based on abi-volun…

2915280

…teer-trends

fix: undefined variable error from getTotalHoursWorked

67ed098

Updated comments in the code for getVolunteerNumberStats function to …

1a42696

…include comparisonPercentage

refactor: update comment for getVolunteerNumberStats

fdd8881

Merge pull request #1184 from OneCommunityGlobal/VolunteerNumberStats…

b19204a

…ComparisonData Denish - Add comparison percentages to getVolunteerNumberStats

Sudershhh mentioned this pull request Dec 22, 2024

Weekly Volunteer Summary Dashboard Components OneCommunityGlobal/HighestGoodNetworkApp#2974

Merged

strallia added 7 commits December 30, 2024 12:27

fix: timeFrame options in getVolunteerTrends

f6678b8

fix: getVolunteerTrends to return total volunteer hours by week

16cabdf

feat: update getVolunteerTrends to get total volunteer hours by month

90053f4

feat: update getVolunteerTrends to use custom date parameters

4cb8996

style: formate code

a7086d2

feat: update getAnniversaries to return user emails

2586d13

Merge branch 'origin/development' into abi-volunteer-trends

eb0f908

one-community merged commit 72424ef into development Jan 12, 2025
3 checks passed

strallia mentioned this pull request Jan 15, 2025

Strallia - Chart Components for Total Org Summary Page OneCommunityGlobal/HighestGoodNetworkApp#3007

Merged

one-community mentioned this pull request Jan 18, 2025

Backend Release to Main [2.10] #1199

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Abi weekly summary reports page #1062

Abi weekly summary reports page #1062

Abi-Liu commented Aug 12, 2024 •

edited

Loading

SMitta11 left a comment

AJAYINAVOLU left a comment

nikhilpittala16 left a comment

oliviahyw left a comment

Parth-tech left a comment

yashwanth170 left a comment

vedantg24 left a comment

vishnupriyaatheti left a comment •

edited

Loading

Shreyav2000 left a comment

sri0606 left a comment

chu-ziyu left a comment

Abi weekly summary reports page #1062

Abi weekly summary reports page #1062

Conversation

Abi-Liu commented Aug 12, 2024 • edited Loading

Description

Changes 9/13

Changes 8/23

Related PRS (if any):

Main changes explained:

How to test:

Screenshots or videos of changes:

SMitta11 left a comment

Choose a reason for hiding this comment

AJAYINAVOLU left a comment

Choose a reason for hiding this comment

nikhilpittala16 left a comment

Choose a reason for hiding this comment

oliviahyw left a comment

Choose a reason for hiding this comment

Parth-tech left a comment

Choose a reason for hiding this comment

yashwanth170 left a comment

Choose a reason for hiding this comment

vedantg24 left a comment

Choose a reason for hiding this comment

vishnupriyaatheti left a comment • edited Loading

Choose a reason for hiding this comment

Shreyav2000 left a comment

Choose a reason for hiding this comment

sri0606 left a comment

Choose a reason for hiding this comment

chu-ziyu left a comment

Choose a reason for hiding this comment

Abi-Liu commented Aug 12, 2024 •

edited

Loading

vishnupriyaatheti left a comment •

edited

Loading